home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / games / addons / btedit.arj / BT3EDIT.DOC next >
Text File  |  1993-09-03  |  23KB  |  493 lines
  1.                                    BT3Edit
  2.                           A Character Editor Program
  3.                   for characters created by the IBM version of
  4.                   The Bard's Tale (R) III - Thief of Fate (TM)
  5.  
  6.                                 Randall Berry
  7.                             341-C Boniface Parkway
  8.                              Anchorage, AK 99504
  9.  
  10. -------------------------------------------------------------------------------
  11. Disclaimers
  12.  
  13.  
  14.   The Bard's Tale (R) III - Thief of Fate (TM) is copyrighted (C) 1988 by
  15. Interplay Productions, Inc. and Electronic Arts, all rights reserved.  This
  16. editing program (BT3Edit) is not endorsed nor approved by Interplay Productions
  17. or Electronic Arts nor is the author of BT3Edit affilliated with these
  18. companies in any way.  The BT3Edit program was not created nor distributed with
  19. the intent to infringe upon the rights of the copyright owners of The Bard's
  20. Tale (R) III, and is intended as a no-cost utility for the users of The Bard's
  21. Tale (R) III software.
  22.  
  23.   All trademarks and copyrights are the property of their respective owners.
  24.  
  25.   The author disclaims all warranties, either expressed or implied, including
  26. but not limited to any implied warranties of merchantability or fitness for a
  27. particular purpose, with respect to this software or documentation.  Use this
  28. software entirely at your own risk.
  29. -------------------------------------------------------------------------------
  30. Licensing
  31.  
  32.   You are hereby granted a limited license to use this software without any
  33. payment to the copyright owner as long as the conditions of this limited
  34. license are met:
  35.  
  36.   1. You may not sell, rent or lease this software.  A disk handling fee not to
  37.      exceed $8.00 may be applied by a software distribution organization.  In
  38.      this case the purchaser must explicitly be made aware that the fee is for
  39.      disk handling and not for this software.
  40.  
  41.   2. If you distribute this software it must contain, in it's original and
  42.      unedited form, the following files:
  43.  
  44.        BT3EDIT.EXE    -  the program file
  45.        BT3EDIT.DOC    -  manual
  46.        BETA_INF.TXT   -  beta tester's report form
  47.  
  48.      These may be stored in a single file using a compression utility for the
  49.      sake of reducing storage requirements.  If so stored, the compressed file
  50.      should have the filename BT3EDIT.xxx, where "xxx" is the appropriate file
  51.      extension for the corresponding compression utility (.ZIP, .PAK, etc.).
  52.  
  53.      The beta tester's report form (BETA_INF.TXT) may be modified for the
  54.      purposes of sending a report to the author, however, if you modify the
  55.      form it should not be distributed with the other files - please send it
  56.      to the author.
  57.  
  58.   3. You may not edit, modify, reverse engineer, decompile or disassemble this
  59.      software, nor modify this document in any fashion.
  60.  
  61.   If you are unable or unwilling to meet the conditions of this license then
  62. do not use the software and remove all copies of it from your possession.
  63. -------------------------------------------------------------------------------
  64. Program Description
  65.  
  66.   BT3Edit is designed to allow you to edit your Bard's Tale III characters
  67. in great detail.  You can edit the characters at the refuge camp ("The Ruin")
  68. near Skara Brae or the characters saved to disk while they were out
  69. adventuring.
  70.  
  71.   Nearly all aspects of your character's are available for editing, including
  72. attributes, class, race, items carried, etc.  BT3Edit was designed both to
  73. help you "boost" your characters a bit through the game, and as a tool to
  74. explore the Bard's Tale game world.
  75. -------------------------------------------------------------------------------
  76. Important Backup Information
  77.  
  78.   This is a beta release of BT3Edit.  Because of this, and the fact that the
  79. program will allow you to completely mangle your Bard's Tale characters if you
  80. choose to do so, you should, BEFORE USING THIS PROGRAM AT ALL, backup your
  81. character files.  This way, if you make any changes to your characters that
  82. you don't like and you cannot remember what you did when you edited your
  83. characters, you can restore your backed-up characters.  BT3Edit does not make
  84. backups for you - you need to do it manually.
  85.  
  86.   The two files you want to backup are:
  87.  
  88.   THIEVES.INF  -  file containing characters at the Skara Brae refuge camp.
  89.   GAME.SAV  -  file containing characters that were saved when out adventuring.
  90.  
  91.   Use DOS's COPY command to backup these files, for example:
  92.   COPY THIEVES.INF THIEVES.BAK
  93.   COPY GAME.SAV GAME.BAK
  94.  
  95.   To restore the files simply reverse the copy procedure:
  96.   COPY THIEVES.BAK THIEVES.INF
  97.   COPY GAME.BAK GAME.SAV
  98.  
  99.   If you have not made a saved game position then the file GAME.SAV may not
  100. exist.  If you don't have enough room on your disk you may want to save these
  101. files to a separate floppy disk.  Remember that if you restore the backed-up
  102. files your characters will be as they were when you had saved then prior to
  103. making the backup copies.  Anything that had happened to them after you made
  104. the backup will be lost.  You may want to make a separate backup copy each
  105. time you plan to use BT3Edit (making the backup before you load BT3Edit, of
  106. course).
  107.  
  108.   Please don't bother trying to tell me that BT3Edit just mangled your
  109. characters, you don't remember what editing you did with BT3Edit, and you
  110. didn't make backup character files to restore from.  By itself, BT3Edit will
  111. not do anything to your files.  It simply gives YOU the ability to modify them.
  112. THIEVES.INF and GAME.SAV are the only two files that BT3Edit can modify,
  113. however, those files contain nearly everything about your Bard's Tale
  114. characters and BT3Edit will allow you to do some very complex changes to them.
  115. Be safe and backup your data files!
  116.  
  117. -------------------------------------------------------------------------------
  118. System Requirements
  119.  
  120.   * an IBM Personal Computer or compatable running MS-DOS or PC-DOS version
  121.       3.2 or higher (may work with lower versions of DOS)
  122.   * at least one floppy disk (hard disk is recommended)
  123.   * 640 kilobytes (K) of installed random access memory (RAM)
  124.   * a color or monochrome monitor
  125.  
  126.   Optional - a Microsoft-compatable mouse
  127.  
  128.   BT3Edit runs in text mode, so the graphics capability of your system is not
  129. an issue.  Any computer capable of running The Bard's Tale III should be able
  130. to use this program.
  131. -------------------------------------------------------------------------------
  132. Beta Test Reports
  133.  
  134.  
  135.   If you would like to help make BT3Edit a better program then I could use your
  136. help.  There is certain information that, if I knew it, could be incorporated
  137. into the program.  For example, the Item Usage Byte (my terminology for the
  138. value that the game program uses to indicate how many uses an item, usually
  139. magical like a wand or figurine, has remaining).  If I knew what value the game
  140. normally sets for each item's usage byte then I could put this information into
  141. BT3Edit so it is set automatically.  Certain values that you might manually set
  142. for the Item Usage Byte are invalid and will cause strange behavior on the part
  143. of The Bard's Tale III program.  If I had the information I could prevent this
  144. from happening.
  145.  
  146.   In addition to the above information on the Item Usage Byte, any other
  147. information, bug reports, and suggestions will be given attention.  I would
  148. like to prepare a release (non-beta) version of BT3Edit soon.  Since I am not
  149. requesting any payment for use of BT3Edit I cannot offer reward whatsoever for
  150. your beta testing assistance, other than it can help to produce a newer version
  151. that is improved and more capable.
  152.  
  153.   Please send your beta reports to me on CompuServe as electronic mail at
  154. user ID# 74620,500 or leave a message on The Gamers Forum.  You can also mail
  155. them to me at the address on the first page of this manual.
  156.  
  157.   Provided with the program should be a file called BETA_INF.TXT which is a      
  158. sample beta tester report form, and may help with documenting.
  159.  
  160.   My sincerest thanks for your assistance.
  161.  
  162.  
  163. -------------------------------------------------------------------------------
  164. Starting, Controlling, and Quitting the Program
  165.  
  166.  
  167.   BT3Edit should be placed in the same directory as your Bard's Tale III game,
  168. if possible.  To start the program, simply type BT3EDIT.  If the colors are off
  169. you may want to start the program with BT3EDIT /M (which will force the program
  170. into monochrome mode).  BT3Edit will use a Microsoft-compatable mouse, if you
  171. have the mouse driver loaded prior to starting the program.
  172.  
  173.   The program uses the now-familiar pulldown menu system.  All commands are
  174. accessed through the pulldown menus.  To activate a menu with the keyboard press
  175. the <Alt> key and, while holding it down, press the highlighted letter of the
  176. menu you want to open.  You then can select a menu item by either pressing the
  177. letter key that corresponds to the highlighted letter of the menu item you want,
  178. or by using the <Up> and <Down> cursor keys to highlight the item and pressing
  179. <Enter>.  Mouse users have an easy time of it also: just place the mouse cursor
  180. over the menu and press the left mouse button, and use the same technique to
  181. select the menu item.
  182.  
  183.   Some commands in the program will display a list box with various choices in
  184. them.  Use the <PgUp>, <PgDn> or the <Up> and <Down> cursor keys to highlight
  185. your choice and press <Enter> to select it.  Mouse users can also use the scroll
  186. bar on the right edge of the list box.  You can also toggle through the choices
  187. by pressing the first letter of the choice to highlight it.
  188.  
  189.   The <Esc> key will normally "back out" of any command, without making any
  190. changes.
  191.  
  192.   To leave the program use the "File Menu - Exit" command or press <Esc>.  If
  193. you have made any changes to a file the program will ask you if you want to
  194. save the changes before exiting.
  195.  
  196.  
  197. -------------------------------------------------------------------------------
  198. Editing Basics
  199.  
  200.  
  201.   The first thing you need to do when you start BT3Edit is to load a character
  202. file for editing.  Select the "File Menu - Open Refuge Camp File" or the "File
  203. Menu - Open Saved Party File" items.  If BT3Edit cannot find the appropriate
  204. files it will ask you for a valid path to those files (i.e., C:\BARDTALE).  Do
  205. not enter the filename, just the path.
  206.  
  207.   The second thing you'll need to do, after a file is successfully loaded, is
  208. to select a character for editing.  Go to the "Character Menu" and choose a
  209. character.  When a character is selected a checkmark appears next to that
  210. character's name in the "Character Menu".  You can only edit one character at
  211. a time, however, you can edit the characters as many times at you want before
  212. saving the file to disk.
  213.  
  214.   Many of the menu items will be "greyed-out" and not selectable unless you have
  215. both a file loaded and a character selected.  For example, you obviously can't
  216. save a file unless one is open.
  217.  
  218.   When you are done making changes to your characters use the "File Menu - Save
  219. Changes" command to save your changes to disk.
  220.  
  221.  
  222. -------------------------------------------------------------------------------
  223. Things To Consider Before Using This Program
  224.  
  225.  
  226.   Some of the values of the changes you can make with BT3Edit are not checked
  227. by the Bard's Tale game program.  What this means is that you can really do some
  228. weird things to your game if you are not cautious.  BT3Edit can be dangerous to
  229. your characters in the wrong hands.  This is the reason for always make a
  230. backup copy of your character data files before using BT3Edit.  If your game
  231. acts strangely after using BT3Edit then you can always restore using the
  232. backup files, or by reversing your changes with BT3Edit (assuming you remember
  233. what you did).
  234.  
  235.   Some of the character values you can set with BT3Edit can cause odd results.
  236. For example, you can use BT3Edit to set up a level 1000 Archmage with a picture
  237. of a slime-dripping monster and equip him with Diamond Plate armor.  Why you
  238. would want to is anyone's guess, but the program will allow it.  If your Bard's
  239. Tale game chokes on the changes, just use BT3Edit to reverse it.  You can have
  240. a lot of fun playing around with the various possibilities.
  241.  
  242.   Nearly every item in the game is available for you to give to your characters.
  243. Some of the items are either worthless or have special meanings that your game
  244. will react to if it sees them in your character's inventories.  Most of the
  245. magical items also have a Usage Byte (a value the game program sets to indicate
  246. how many times the item can be used).  I do not know what values the game sets
  247. for the Usage Byte of each item, so if you adjust this value using BT3Edit then
  248. you should be aware that items can act differently than if your characters found
  249. these items during the normal course of the game.
  250.  
  251.   The Bard's Tale is a carefully crafted game.  Using BT3Edit can completely
  252. spoil the normal gameplay the the Bard's Tale designers had envisioned.  Be
  253. aware that this editor, like nearly any other game editor, is a form of "cheat
  254. sheet".  If you don't want any help with your game then don't use BT3Edit.
  255. Likewise, if you just want a few more experience points to be able to make
  256. a level 10 magician then just use BT3Edit for that purpose only.  If you feel
  257. that using BT3Edit has spoiled your enjoyment of the Bard's Tale, don't say I
  258. didn't warn you of the possibility.
  259.  
  260.  
  261. -------------------------------------------------------------------------------
  262. Program Limitations
  263.  
  264.  
  265.   The Bard's Tale III will allow you to keep up to 30 characters stored at any
  266. one time.  Because of the way in which the menu system was designed, BT3Edit
  267. will only allow you to select and edit the first 22 characters.  If you have
  268. more than 22, you may want to delete the weak ones and keep your roster of
  269. stored characters to 22 or less.  You really don't need more than that anyway,
  270. not with BT3Edit's abilities to modify characters.
  271.  
  272.   Some things that your Bard's Tale game already does, such as creating and
  273. renaming characters, are not duplicated in BT3Edit.
  274.  
  275.  
  276. -------------------------------------------------------------------------------
  277. Menu Command Summaries
  278.  
  279.  
  280. File Menu
  281. ---------
  282.  
  283. "Open Refuge Camp File"
  284.   Opens the file containing information on the characters at the refuge camp
  285.   near Skara Brae.  Once the file is opened you can select a character from the
  286.   "Character Menu" and start editing.
  287.  
  288.   If the file isn't in the current path then you will be asked for a new path.
  289.  
  290.  
  291. "Open Saved Party File"
  292.   Opens the file containing information on the characters who were saved to
  293.   disk while out adventuring.  Notice that a character in the Saved Party File
  294.   is also in the Refuge Camp File.  The information in the Saved Party File
  295.   will be used by the game program if you tell it to restore your last saved
  296.   game.
  297.  
  298.   If the file isn't in the current path then you will be asked for a new path. 
  299.  
  300.  
  301. "Save Changes"
  302.   Saved the currently loaded file to disk, overwriting the original file.
  303.  
  304.  
  305. "Exit to DOS"
  306.   Exits BT3Edit and returns you to DOS.  You will be asked if you want to save
  307.   any changes you have made to the current file, if applicable.
  308.  
  309.  
  310. Character Menu
  311. --------------
  312.  
  313.   If you haven't opened a file yet, this menu will just display "(None
  314.   available").  If a file is already open, the names of the characters that
  315.   are contained in that file are displayed here.  Simply choose a character
  316.   and you are ready to edit.  The various characteristics of the selected
  317.   character will appear in the center of the screen.
  318.  
  319.  
  320. Attributes Menu
  321. ---------------
  322.  
  323. "Strength..."
  324.   Allows you to change the character's strength attribute.
  325.  
  326. "Intelligence..."
  327.   Allows you to change the character's strength attribute.
  328.  
  329. "Dexterity..."
  330.   Allows you to change the character's dexterity attribute.
  331.  
  332. "Constitution..."
  333.   Allows you to change the character's constitution attribute.
  334.  
  335. "Luck..."
  336.   Allows you to change the character's luck attribute.
  337.  
  338. "Sex..."
  339.   According to the game's documentation, the setting for the character's sex
  340.   only affects which picture the program shows you for the character.  Since
  341.   BT3Edit allows you to manually set a character picture, this command is just
  342.   included `what the heck'.  If you do choose to change the character's sex
  343.   (sorry... only two choices, folks) then BT3Edit will automatically change
  344.   the characters picture number.  The program will also do this is you change
  345.   the character's class.  If you have set a custom character picture number
  346.   that you like then you should write it down before changing the character's
  347.   sex or class, so you can reset that custom number afterwards.
  348.  
  349. "Race..."
  350.   The character's race appears to affect the base attributes (strength, luck,
  351.   etc.) for that character.  The attributes can be manually set using BT3Edit
  352.   (see above).  Simply select a new race from the list box.
  353.  
  354. "Character Picture..."
  355.   A little complaint: The Bard's Tale III is really stingy about giving you a
  356.   wide selection of character pictures (those little animated pictures that are
  357.   displayed when you examine your characters).  There's a fair number of
  358.   pictures available in the game, unfortunately they are mostly such undesireable
  359.   things as monsters, assorted beasties, etc.  The main reason I put this
  360.   command in BT3Edit is so you can view some of the pictures, and for that it
  361.   can be a bit of fun.  Note that not all of the 256 possible picture choices
  362.   are valid, and if you get weird results just leave the game and use BT3Edit
  363.   to set the picture back to what it should be (see the following command).
  364.  
  365. "Reset Character Picture"
  366.   If you use the previous command to make your character look like Tarjan, a
  367.   room full of rats or something else you'd rather not look at, you can easily
  368.   select this command to put the character picture back to what it should be.
  369.  
  370.  
  371. Status Menu
  372. -----------
  373.  
  374. "Condition..."
  375.   There are several things that can affect your characters, including being
  376.   "old", "poisoned", "dead", etc.  None of them are desirable.  Selecting this
  377.   command will return your character to health.  Sorry, but you can't make a
  378.   character old or dead with this command, only heal them of such a condition.
  379.  
  380. "Hit Points - Maximum..."
  381.   The character's maximum hit points are the total amount of damage that the
  382.   character can sustain before dying on you.  The maximum value is the value
  383.   that is set if the character is in perfect health.
  384.  
  385. "Hit Points - Current..."
  386.   This value is the current amount of damage the character can sustain before
  387.   expiring.  BT3Edit will not allow you to set a higher current value that
  388.   the maximum value (see "Status Menu - Hit Points - Maximum").
  389.  
  390. "Experience Points..."
  391.   Experience points are used to indicate if a certain character is ready for
  392.   advancement to the next level in his or her class.  This command will allow
  393.   you to set a new value for the current character.
  394.  
  395. "Gold..."
  396.   Having a fair amount of gold can be handy sometimes.  This command will allow
  397.   you to set a new value for the current character.
  398.  
  399.  
  400. Abilities Menu
  401. --------------
  402.  
  403. "Class..."
  404.   This can be real handy, in that this is where you can turn a magician into
  405.   an archmage, for example.  This command only affects the character's class,
  406.   and does not give nor take away spell points, class level, etc.  If you turn
  407.   a character into a different type of magic user, you will still need to
  408.   return to the Old Man at the Review Board in Skara Brae to learn the spells
  409.   for that new class.
  410.  
  411.   Also, see the above notes in the manual about the way BT3Edit changes your
  412.   character's picture number, in the "Attribute Menu - Sex" command
  413.   description.
  414.  
  415. "Class Level - Maximum..."
  416.   Allows you to change the character's maximum level in his or her occupation
  417.   class, i.e., a level 7 or level 12 Magician.  This is the maximum value for
  418.   a character in good health.
  419.  
  420. "Class Level - Current..."
  421.    Allows you to change the character's current class level.  This value may be
  422.    different than the maximum class level, depending on the character's health.
  423.    BT3Edit will not allow you to set a higher current value than the maximum.
  424.  
  425. "Spell Points - Maximum..."
  426.   Allows you to change the maximum number of spell points that the character
  427.   has.  This is the amount set if the character's spell points are completely
  428.   recharged (by using a Harmonic Gem, for example).  You could have 1000 spell
  429.   points but not know any spells for your character's class.  You need to visit
  430.   the Old Man in Skara Brae for that purpose.  Make sure that your character
  431.   has some gold to pay for the new spells.
  432.  
  433. "Spell Points - Current..."
  434.   Allows you to change the character's current spell points.  As your characters
  435.   cast spells they use up spell points.  BT3Edit will not allow you to set a
  436.   higher current value than the maximum.
  437.  
  438.  
  439. Items Menu
  440. ----------
  441.  
  442. "Add an Item..."
  443.   Allows you to add an item to the character's inventory.  Each character can
  444.   carry a maximum of 12 items at any one time.
  445.  
  446.   You will notice several items simply called "x".  They don't seem to do
  447.   anything, and I have just included them because the Bard's Tale program
  448.   recognizes them.
  449.  
  450. "Change an Item..."
  451.   Allows you to change a specific item in the character's inventory from one
  452.   item to another.  You could change a torch to a lamp, for example.
  453.  
  454. "Delete an Item..."
  455.   Allows you to delete an item from the character's inventory.
  456.  
  457. "Modify Item Usage Byte..."
  458.   This command can be a bit tricky.  Each item in a character's inventory has
  459.   a separate byte (a number from 0 to 255) that appears to store the number
  460.   of uses the item has remaining.  For instance, you can use this to store
  461.   up to 254 charges in a harmonic gem (a handy thing to have, no?).  Use with
  462.   care, in that I'm not sure what else (if anything) this byte is used for.
  463.  
  464.   If you set this value to 255 then the item is inert (this is the normal
  465.   value for many items).
  466.  
  467.   Be aware that some values may not make any sense to the game program.  To set
  468.   a usage value for an item which does not need one isn't going to do any good,
  469.   for example, a usage value for a suit of chain mail.
  470.  
  471.   If you'd like to help beta-test and help make BT3Edit a better program please
  472.   see the section in the manual on "Beta Test Reports".  If I can find out what
  473.   the game sets for each Item Usage Byte then I can put that information into
  474.   BT3Edit so it is set automatically when you edit a character.
  475.  
  476. "Toggle Equipped Status..."
  477.   Changes an item in the character's inventory from equipped to unequipped and
  478.   backwards.  You should be aware that some items are not normally usable by
  479.   a given character, i.e., a magician normally cannot equip a sword, etc.
  480.  
  481. "View Available Items..."
  482.   Displays a scrollable list box of the items that are available.
  483.  
  484.  
  485. Miscellaneous Menu
  486. ------------------
  487.  
  488. "About This Program..."
  489.   Displays program copyright and other information.
  490.  
  491.  
  492. -------------------------------------------------------------------------------
  493.